home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / disk / misc / SCSIQuery.readme < prev    next >
Encoding:
Text File  |  1999-11-06  |  9.8 KB  |  276 lines
  1. Short:    Prints internal infos of SCSI devices
  2. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Version:  1.32
  5. Type:     disk/misc
  6. Requires: Os 2.04, a true SCSI-2 device (HD,CD mostly)
  7.  
  8. _____________________________________________________________________________
  9.  
  10. Changes made for 1.32:
  11.  
  12. - Added more support for Iomega, mainly JAZ related.
  13. _____________________________________________________________________________
  14.  
  15. Changes made for 1.30:
  16.  
  17. - Fixed a bug for the notch page output.
  18. - Added notch support, can be disabled with the NONOTCHES option.
  19. _____________________________________________________________________________
  20.  
  21. Changes made for 1.21:
  22.  
  23. - Disabled one error check when getting the extended inquiry data. Some
  24.   old device drivers seem to fail getting them correctly. I can't reproduce
  25.   this.
  26. _____________________________________________________________________________
  27.  
  28. Changes made for 1.20:
  29.  
  30. - Fixed a *fatal* bug that could have caused really serious crashes.
  31.   Forgot to cast correctly, leading trashing innocent memory. Outch!
  32.   *Sorry, sorry, sorry, sorry!*
  33. - Enhanced the Iomega extension output.
  34. _____________________________________________________________________________
  35.  
  36. Changes made for 1.19:
  37.  
  38. - Made the defect list format selectable, with autoselect for Iomega.
  39. - SCSIQuery prints now the extended INQUIRY data.
  40. - SCSIQuery detects now automatically whether a device name or a DOS
  41.   device driver is given.
  42. _____________________________________________________________________________
  43.  
  44. Changes made for 1.18:
  45.  
  46. - Added more sanity checks, fixed a possible enforcer hit. Thanks to 
  47.   Gene Heskett for reporting.
  48. - Changed the bad block default format to head/sector addressing rather
  49.   than bytes from index. This avoids trouble with Iomega devices.
  50. _____________________________________________________________________________
  51.  
  52. This tool prints all internal information of a SCSI device it can hold
  53. of, including the mode pages and the bad block lists. This might be 
  54. interesting for developers of SCSI software and hardware.
  55.  
  56. SCSIQuery replaces the older ProbSCSI which doesn't seem to run stable under
  57. certain (and in some sense broken) hardware, like the CyberSCSI device
  58. which doesn't seem to follow the RKRMs on each word. 
  59.  
  60.  
  61. Features:
  62.  
  63.     - Prints the device inquiry status
  64.     - Prints SCSI mode pages by their structure. It knowns most
  65.       HD and CD rom pages, and unknown pages are printed in hex dump.
  66.     - Prints the device capacity.
  67.     - Prints the defect list.
  68.     - Knows some Iomega extensions, most noticable for ZIP and JAZ.    
  69.       However, this is far from being complete due to the strange
  70.       information policy of Iomega.
  71.     - tested on the gvpscsi.device, the oktagon.device and the
  72.       (cyber)scsi.device. Should work on every device that follows
  73.       the RKRMs scsi.device documentations (roughly, at least).
  74.  
  75. To do:
  76.     Quite a lot, actually. However, it doesn't look I'm gonna have a
  77.     lot of time to develop this program further. It currently does what
  78.     it is supposed to do, but could do a lot better.
  79.  
  80.     - A GUI is missing. I'm just to lazy to write one in the current
  81.       state of this program.
  82.     - SCSIQuery doesn't allow to change or save the mode pages.
  83.     - Only mode pages for HD and CD are supported, no scanner/printer/
  84.       floptical and other SCSI device support. More mode pages might
  85.       be added on request.
  86.     - No LOG PAGES support yet.
  87.     - The readme is really a bit unhelpful. This program really lacks
  88.       a full detailed guide. However, lack of time... (-;
  89.  
  90.  
  91. Additional note:
  92.  
  93. Requests about what the output of this program means ARE NOT welcome. The
  94. SCSI-II specifications are available in public and they include all this
  95. information. 
  96.  
  97.  
  98. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  99.  
  100. More SCSI mode page informations. I'm able to implement all official pages
  101. of the SCSI-II specifications since I've a copy of the SCSI specifications,
  102. however, there are more, vendor specific pages I've no idea about. Getting
  103. hold of the Iomega specifications - not the output of the program - 
  104. would really, really help.
  105.  
  106. If you've ANY information about these (not the official SCSI-II pages!) 
  107. additional pages, please, please PLEASE LEMME KNOW!
  108.  
  109. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  110. _________________________________________________________________________________
  111.  
  112. Installation:
  113.  
  114.     Just copy it whereever you want to keep it. Needs nothing more.
  115.  
  116.  
  117. Synopsis:
  118.  
  119. SCSIQuery HANDLER=DEVICE/A,UNIT/N,FLAGS/N,DEFECTLIST/K,NONOTCHES/S
  120.  
  121.     
  122.     HANDLER=DEVICE    the name of the DOS handler controlling a SCSI    
  123.             device. DO NOT specify handlers that are not
  124.             linked to SCSI devices, this will either abort
  125.             with an error message in the best case, or crashes
  126.             the system in the worst case. You *HAVE TO* place
  127.             a trailing colon ":", e.g. "ZIP:".
  128.             Alternatively, an exec style device, it *MUST*
  129.             end with ".device", e.g. "omniscsi.device"
  130.  
  131.     UNIT        the unit of the exec device to investigate, required
  132.             if an exec device name was specified.
  133.  
  134.     FLAGS        flags used for opening the specific device;
  135.             defaults to zero and are not required in most cases.
  136.  
  137.     DEFECTLIST    the type of defect list to inquiry from the device.
  138.             Possible defect list specifiers are:
  139.  
  140.         OFF        Do not print a defect list.
  141.         INDEX        Specify defaults as bytes from an index on 
  142.                 the tracks.
  143.         PHYSICAL    Specify defaults as physical head, cylinder
  144.                 and block.
  145.         BLOCK        Specify defects as block offsets from the
  146.                 start of the drive.
  147.         DEFAULT        Use the INDEX method for all drivers except
  148.                 for Iomega devices which use the PHYSICAL
  149.                 type.
  150.  
  151.     NONOTCHES    disables notch specific information. In case
  152.             SCSIQuery finds that the device to be investigated
  153.             has more than one notch, SCSIQuery will try to
  154.             print the notch dependent information separately
  155.             for each notch available. 
  156.  
  157. Examples:
  158.  
  159.  
  160. To investigate your system partition, try:
  161.  
  162. SCSIQuery DH0:
  163.  
  164.  
  165. To print information about your CD ROM, try:
  166.  
  167. SCSIQuery CD0:
  168.  
  169.  
  170. To query the SCSI device connected to the "gvpscsi.device", unit 6, try:
  171.  
  172. SCSIQuery gvpscsi.device UNIT=6
  173.  
  174.  
  175. To query the SCSI device connected to the "oktagon.device", unit 0, try:
  176.  
  177. SCSIQuery oktagon.device UNIT=0
  178.  
  179. _____________________________________________________________________________
  180.  
  181. Special thanks goes to Werner Müller for testing. This program was actually
  182. written to help him finding problems in his SCSI configuration.
  183. _____________________________________________________________________________
  184.  
  185.                          The THOR-Software Licence (v2, 24th June 1998)
  186.  
  187.  
  188. This License applies to the computer programs known as "SCSIQuery".
  189. The "Program", below, refers to such program. The "Archive" refers to the 
  190. original and unmodified package of distribution, as prepared by the author 
  191. of the Program. Each licensee is addressed as "you".
  192.  
  193.  
  194.  
  195. The Program and the data in the archive are freely distributable
  196. under the restrictions stated below, but are also Copyright (c)
  197. Thomas Richter.
  198.  
  199. Distribution of the Program, the Archive and the data in the Archive by a
  200. commercial organization without written permission from the author to any
  201. third party is prohibited if any payment is made in connection with such
  202. distribution, whether directly (as in payment for a copy of the Program) or
  203. indirectly (as in payment for some service related to the Program, or
  204. payment for some product or service that includes a copy of the Program
  205. "without charge"; these are only examples, and not an exhaustive enumeration
  206. of prohibited activities).
  207.  
  208.  
  209. However, the following methods of distribution
  210. involving payment shall not in and of themselves be a violation of this
  211. restriction:
  212.  
  213.  
  214. (i) Posting the Program on a public access information storage and
  215. retrieval service for which a fee is received for retrieving information
  216. (such as an on-line service), provided that the fee is not
  217. content-dependent (i.e., the fee would be the same for retrieving the same
  218. volume of information consisting of random data).
  219.  
  220.  
  221. (ii) Distributing the Program on a CD-ROM, provided that
  222.  
  223. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  224. especially this licence agreement;
  225.  
  226. b) the CD-ROM is made available to the public for a nominal fee only,
  227.  
  228. c) a copy of the CD is made available to the author for free except for
  229. shipment costs, and
  230.  
  231. d) provided further that all information on such CD-ROM is redistributable
  232. for non-commercial purposes without charge.
  233.  
  234.  
  235. Redistribution of a modified version of the Archive, the Program or the
  236. contents of the Archive is prohibited in any way, by any organization,
  237. regardless whether commercial or non-commercial. Everything must be kept
  238. together, in original and unmodified form.
  239.  
  240.  
  241.  
  242.  
  243. Limitations.
  244.  
  245.  
  246. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  247. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  248. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  249. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  250. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  251. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  252. SERVICING, REPAIR OR CORRECTION.
  253.  
  254.  
  255. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  256. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  257. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  258.  
  259.  
  260.                                                         Thomas Richter
  261. _____________________________________________________________________________
  262.  
  263. And now, have fun!
  264.  
  265.     Thomas        (September 1999)
  266.  
  267.  
  268. ============================= Archive contents =============================
  269.  
  270. Original  Packed Ratio    Date     Time    Name
  271. -------- ------- ----- --------- --------  -------------
  272.    38984   14903 61.7% 19-Sep-99 00:21:08 +SCSIQuery
  273.     9673    3964 59.0% 19-Sep-99 00:56:54 +SCSIQuery.readme
  274. -------- ------- ----- --------- --------
  275.    48657   18867 61.2% 14-Oct-99 21:14:40   2 files
  276.